The user can select a new directory to examine by scrolling
through the list of directories and selecting the desired
directory or by editing the directory mask. Selecting a new
directory from the directory list does not change the search
pattern. A user can select a new search pattern by editing
the directory mask or, when the FileSelectionBox has the
optional XXXXmmmmNNNNppppaaaatttthhhhMMMMooooddddeeee XXXXmmmmPPPPAAAATTTTHHHH____MMMMOOOODDDDEEEE____RRRREEEELLLLAAAATTTTIIIIVVVVEEEE display, the
filter text field. Double clicking or pressing KKKKAAAAccccttttiiiivvvvaaaatttteeee on
a directory in the directory list initiates a search for
files and subdirectories in the new directory, using the
current search pattern.
The user can select a file by scrolling through the list of
filenames and selecting the desired file or by entering the
filename directly into the text edit area. Selecting a file
from the list causes that filename to appear in the file
selection text edit area.
The user may select a new file as many times as desired.
The application is not notified until the user takes one of
the following actions:
+o Selects the _O_K PushButton
+o Presses KKKKAAAAccccttttiiiivvvvaaaatttteeee while the selection text edit area
has the keyboard focus
+o Double clicks or presses KKKKAAAAccccttttiiiivvvvaaaatttteeee on an item in the
file list
FileSelectionBox initiates a directory and file search when
any of the following occurs:
+o The FileSelectionBox is initialized
+o The function XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss is used to change XXXXmmmmNNNNddddiiiirrrrMMMMaaaasssskkkk,
XXXXmmmmNNNNddddiiiirrrreeeeccccttttoooorrrryyyy, XXXXmmmmNNNNppppaaaatttttttteeeerrrrnnnn, or XXXXmmmmNNNNffffiiiilllleeeeTTTTyyyyppppeeeeMMMMaaaasssskkkk
+o The user activates the FFFFiiiilllltttteeeerrrr PushButton
+o The user double clicks or presses KKKKAAAAccccttttiiiivvvvaaaatttteeee on an item
in the directory list
+o The application calls XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDooooSSSSeeeeaaaarrrrcccchhhh
+o The user presses KKKKAAAAccccttttiiiivvvvaaaatttteeee while the directory mask
text edit area has the keyboard focus
When a file search is initiated, the FileSelectionBox takes
If the input _p_a_t_t_e_r_n is NULL, the procedure
constructs the output _p_a_t_t_e_r_n as follows: If the
input _m_a_s_k member is NULL, the procedure uses the
widget's XXXXmmmmNNNNppppaaaatttttttteeeerrrrnnnn as the output _p_a_t_t_e_r_n;
otherwise, it extracts the output _p_a_t_t_e_r_n from the
input _m_a_s_k. If the resulting output _p_a_t_t_e_r_n is
empty, the procedure uses a pattern that matches
all files instead.
The data qualification procedure constructs the
output _m_a_s_k from the output _d_i_r and _p_a_t_t_e_r_n. The
procedure must ensure that the output _d_i_r,
_p_a_t_t_e_r_n, and _m_a_s_k are fully qualified.
If the input _v_a_l_u_e member is not NULL, the
procedure must copy it to the output _v_a_l_u_e member;
otherwise, the procedure must copy the widget's
XXXXmmmmNNNNddddiiiirrrrSSSSppppeeeecccc to the output _v_a_l_u_e.
The data qualification procedure must calculate
the lengths of the output _v_a_l_u_e, _m_a_s_k, _d_i_r, and
_p_a_t_t_e_r_n members and must fill in the corresponding
length members of the output callback struct.
The data qualification procedure must copy the
input _r_e_a_s_o_n and _e_v_e_n_t members to the
corresponding output members.
The values of the XXXXmmmmNNNNddddiiiirrrrSSSSeeeeaaaarrrrcccchhhhPPPPrrrroooocccc and XXXXmmmmNNNNffffiiiilllleeeeSSSSeeeeaaaarrrrcccchhhhPPPPrrrrooooccccare
procedure pointers of type XXXXmmmmSSSSeeeeaaaarrrrcccchhhhPPPPrrrroooocccc, defined as follows:
void (* XmSearchProc) (_w, _s_e_a_r_c_h__d_a_t_a)
Widget _w;
XtPointer _s_e_a_r_c_h__d_a_t_a;
_w The FileSelectionBox widget
_s_e_a_r_c_h__d_a_t_a
Pointer to an XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt
containing information for conducting a search
The value of the XXXXmmmmNNNNqqqquuuuaaaalllliiiiffffyyyySSSSeeeeaaaarrrrcccchhhhDDDDaaaattttaaaaPPPPrrrroooocccc resource is a
procedure pointer of type XXXXmmmmQQQQuuuuaaaalllliiiiffffyyyyPPPPrrrroooocccc, defined as follows:
Calls the activate callbacks for the cancel button
if it is sensitive. If no cancel button exists
and the parent of the FileSelectionBox is a
manager, it passes the event to the parent.
<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>> in Selection Text:
Calls the selection text widget's
XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNmmmmuuuussssttttMMMMaaaattttcccchhhh is
True and the selection text does not match an item
in the file list, it calls the
XXXXmmmmNNNNnnnnooooMMMMaaaattttcccchhhhCCCCaaaallllllllbbbbaaaacccckkkkcallbacks with reason
XXXXmmmmCCCCRRRR____NNNNOOOO____MMMMAAAATTTTCCCCHHHH. Otherwise, it calls the
XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason XXXXmmmmCCCCRRRR____OOOOKKKK.
<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>> in Directory Mask Text:
Calls the directory mask text widget's
XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkkcallbacks, initiates a
directory and file search, and calls the
XXXXmmmmNNNNaaaappppppppllllyyyyCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason XXXXmmmmCCCCRRRR____AAAAPPPPPPPPLLLLYYYY.
<<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>((((2222++++)))) or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>> in Directory List:
Calls the directory list widget's
XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkcallbacks, initiates a
directory and file search, and calls the
XXXXmmmmNNNNaaaappppppppllllyyyyCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason XXXXmmmmCCCCRRRR____AAAAPPPPPPPPLLLLYYYY.
<<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>((((2222++++)))) or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>> in File List:
Calls the file list widget's
XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkcallbacks and calls the
XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk callbacks with reason XXXXmmmmCCCCRRRR____OOOOKKKK.
<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>> in Directory List:
Generates a new directory mask, using the selected
list item as the directory and the pattern
extracted from the current directory mask text as
the search pattern. If the search pattern is
empty, it uses a pattern that matches all files in